home *** CD-ROM | disk | FTP | other *** search
/ PCMania 75 / PCMania CD75_1.iso / powerq / DRVIMAGE / DIAPPS.Z / DISCRIPT.TXT < prev    next >
Text File  |  1998-10-01  |  8KB  |  258 lines
  1. Drive Image Professional Scripting
  2.  
  3. Interactive vs. Batch Mode
  4. --------------------------
  5.  
  6.   Drive Image Professional may be run in one of two modes: interactive
  7.   (the default) or batch mode. Interactive mode requires user input at
  8.   discrete intervals, resulting in greater control and efficiency when
  9.   working with one or two workstations.
  10.  
  11.   Alternately, batch mode is useful when loading image files onto a
  12.   large number of workstations. Batch mode automates the loading
  13.   process, saving you time and effort by eliminating the need for
  14.   repetitive user input.
  15.  
  16.  
  17. Command Line Switches
  18. ---------------------
  19.   In order to run in batch mode, Drive Image Professional uses a series
  20.   of command line switches. To use these switches, type
  21.  
  22.           PQDI /switch [/switch...]
  23.  
  24.   where switch is one or more of the following:
  25.  
  26.   /? Displays all available command line switches, their syntax and
  27.   a short description.
  28.  
  29.   /IMG=<imagefilename> Designates a .PQI image file
  30.  
  31.   /CEC Checks for an extra cylinder.  This corrects a problem of the BIOS and
  32.   DOS reporting different maximum cylinder numbers.
  33.  
  34.   /CMD=<scriptfilename> Designates a script file; the script file
  35.   contains commands that are passed to the program
  36.  
  37.   /LOG=<logfilename> Designates a log file
  38.  
  39.   /ERR=<errorfilename> Designates an error file
  40.  
  41.   /SCO  Syntax Check Only; this switch causes the syntax of each command
  42.   in the script file to be checked without executing the command.
  43.  
  44.   /WFS  Wipe First Sector; deletes the master boot record once all
  45.   partitions are deleted with the script command DELETE ALL; only
  46.   accessible using scripting.
  47.  
  48.   /PWD=<password> Designates a password that must be given to restore
  49.   the partition(s) data.  The password may be either a number or a string.
  50.  
  51.   /CAS The Copy All Sectors switch causes all sectors within a partition to be
  52.   saved and restored. This includes all information in a partition including the
  53.   deleted files.
  54.  
  55.   /IFC   Ignores file system checks.  This allows a partition with a known
  56.   file system error (e.g. cross-linked files) to be stored in an image.
  57.   Likewise, that same partition can be restored if this switch is used and
  58.   if during the restore process the partition does not need to be resized.
  59.  
  60.   /MFS=nnnnn  Designates the Maximum File Size used for creating multiple
  61.   files to contain a .PQI image. (nnnnn is the number of bytes in each file)
  62.  
  63.   /NBS Disable bad sector checking. By default bad sector checking is
  64.   disabled.
  65.  
  66.   /CBS Enable bad sector checking.
  67.  
  68.   /IPE Disables partition table error checking.  This switch allows drives
  69.   with partition errors to be saved and restored.
  70.  
  71.   /UEB forces the extended BIOS to be used for disk reads and writes.
  72.  
  73.   /RAV causes each sector written to disk during the restore process to be
  74.   read back and compared with the data just written as an extra security
  75.   precaution. Using this parameter will significantly increase restore time.
  76.  
  77.  
  78. Command Line Examples
  79. ---------------------
  80.  
  81.   Scenario 1: To specify SCRIPT.TXT as the script file, ERROR.TXT as
  82.   the error file and E:\IMAGES\DRIVE2.PQI as the image file:
  83.  
  84.     PQDI /CMD=SCRIPT.TXT /ERR=ERROR.TXT /IMG=E:\IMAGES\DRIVE2.PQI
  85.  
  86.   Scenario 2: To specify a syntax check for the script file SCRIPT.TXT:
  87.  
  88.     PQDI /CMD=SCRIPT.TXT /SCO
  89.  
  90.  
  91. Script Files
  92. ------------
  93.  
  94.   The script file designated in the command line contains instructions,
  95.   one per line, that are passed to the program, determining
  96.   which operations are executed. The script file syntax is as follows:
  97.  
  98.   Script Argument         Action
  99.   ---------------         ------
  100.   DELETE                  Deletes the last partition selected
  101.  
  102.   DELETE ALL              Deletes all partitions on the drive
  103.  
  104.   DELETE EXTENDED         Deletes the extended partition; the extended
  105.                           partition can only be deleted if all the
  106.                           logical drives within it have already been
  107.                           deleted.
  108.  
  109.   REBOOT                  Reboots the computer; any commands following
  110.                           this command will not be executed
  111.  
  112.   RESIZE IMAGE            Resizes the image to the specified size when
  113.   {proportional |         restored; <number> is indicated in MB
  114.    no | <number> | max}
  115.  
  116.   RESTORE                 Restores all selected images and resizes
  117.                           them, if specified
  118.  
  119.   SECTOR CHECK {on | off} Enables/Disables Bad Sector Checking for all
  120.                           restore operations following the command
  121.  
  122.   SELECT DRIVE {<number>} Selects the drive with the specified number;
  123.                           the first drive is number 1
  124.  
  125.   SELECT FREE SPACE       Selects the specified free space
  126.   {first |last | next |
  127.   largest}
  128.  
  129.   SELECT IMAGE            Selects the specified image in the image file
  130.   {<number> |all}
  131.  
  132.   SELECT PARTITION        Selects the specified partition(s)
  133.   {<driveletter> |
  134.   <volumelabel> |<number>
  135.   | first |next | all}
  136.  
  137.   SET ACTIVE              Sets active the last partition selected
  138.  
  139.   STORE {with compression Stores all selected partitions with the
  140.   {off | low | high}}     indicated compression level
  141.  
  142.  
  143.  
  144. Script File Examples
  145. --------------------
  146.  
  147.   Scenario 1: To store all the partitions on drive 2 to the file,
  148.   E:\IMAGES\DRIVE2.PQI:
  149.  
  150.     PQDI /CMD=SCRIPT.TXT /IMG=E:\IMAGES\DRIVE2.PQI
  151.  
  152.   SCRIPT.TXT file contents:
  153.  
  154.     SELECT DRIVE 2
  155.     SELECT PARTITION ALL
  156.     STORE
  157.  
  158.   Scenario 2: To store partition 3 from drive 1, and partitions 1, 4
  159.   and 5 from drive 2 to the file, E:\IMAGES\DRIVES.PQI and have the
  160.   image file split up into multiple files each 630 MB so each can be
  161.   transferred to a CD-ROM:
  162.  
  163.     PQDI /CMD=SCRIPT.TXT /IMG=E:\IMAGES\DRIVES.PQI /MFS=630000000
  164.  
  165.   SCRIPT.TXT file contents:
  166.  
  167.     SELECT DRIVE 1
  168.     SELECT PARTITION 3
  169.     STORE
  170.     SELECT DRIVE 2
  171.     SELECT PARTITION 1
  172.     SELECT PARTITION 4
  173.     SELECT PARTITION 5
  174.     STORE
  175.  
  176.   Scenario 3: To restore all the images in the file,
  177.   E:\IMAGES\DRIVES.PQI, to the first free space on drive 2:
  178.  
  179.     PQDI /CMD=SCRIPT.TXT /IMG=E:\IMAGES\DRIVES.PQI
  180.  
  181.   SCRIPT.TXT file contents:
  182.  
  183.     SELECT DRIVE 2
  184.     SELECT FREESPACE FIRST
  185.     SELECT IMAGE ALL
  186.     RESTORE
  187.  
  188.   Scenario 4: To restore the first two images in the file,
  189.   E:\IMAGES\DRIVES.PQI, to the largest free space on drive 1
  190.   and resize them both proportionally:
  191.  
  192.     PQDI /CMD=SCRIPT.TXT /IMG=E:\IMAGES\DRIVES.PQI
  193.  
  194.   SCRIPT.TXT file contents:
  195.  
  196.     SELECT DRIVE 1
  197.     SELECT FREESPACE LARGEST
  198.     SELECT IMAGE 1
  199.     SELECT IMAGE 2
  200.     RESIZE IMAGE PROPORTIONAL
  201.     RESTORE
  202.  
  203.   Scenario 5: To restore the first two images in the file,
  204.   E:\IMAGES\DRIVES.PQI, to the last free space on drive 1 and
  205.   resize them to 500 MB each (The image was encrypted using the
  206.   password 12345678):
  207.  
  208.     PQDI /CMD=SCRIPT.TXT /IMG=E:\IMAGES\DRIVES.PQI /PWD=12345678
  209.  
  210.   SCRIPT.TXT file contents:
  211.  
  212.     SELECT DRIVE 1
  213.     SELECT FREESPACE LAST
  214.     SELECT IMAGE 1
  215.     RESIZE IMAGE 500
  216.     SELECT IMAGE 2
  217.     RESIZE IMAGE 500
  218.     RESTORE
  219.  
  220.   Scenario 6: To delete all existing partitions on drive 2 and then
  221.   restore all the images in file, E:\IMAGES\DRIVES.PQI, to the
  222.   free space (The image was encrypted using the password HELLO):
  223.  
  224.     PQDI /CMD=SCRIPT.TXT /IMG=E:\IMAGES\DRIVES.PQI /PWD=HELLO
  225.  
  226.   SCRIPT.TXT file contents:
  227.  
  228.     SELECT DRIVE 2
  229.     DELETE ALL
  230.     SELECT FREESPACE FIRST
  231.     SELECT IMAGE ALL
  232.     RESTORE
  233.  
  234.   Scenario 7: To restore the first four images in the file,
  235.   E:\IMAGES\DRIVES.PQI, to the last free space on drive 1, and
  236.   then resize the first image to 500 MB, keep the second the same
  237.   size, and resize the third and fourth images to proportionally
  238.   take up the remaining free space:
  239.  
  240.     PQDI /CMD=SCRIPT.TXT /IMG=E:\IMAGES\DRIVES.PQI
  241.  
  242.   SCRIPT.TXT file contents:
  243.  
  244.     SELECT DRIVE 1
  245.     SELECT FREESPACE LAST
  246.     SELECT IMAGE 1
  247.     RESIZE IMAGE 500
  248.     SELECT IMAGE 2
  249.     RESIZE IMAGE NO
  250.     SELECT IMAGE 3
  251.     SELECT IMAGE 4
  252.     RESIZE IMAGE PROPORTIONAL
  253.     RESTORE
  254.  
  255.  
  256.   NOTE: For further Drive Image script scenarios, visit our home page at
  257.   http://www.powerquest.com.
  258.